Skip to content

Docs: state that WASM function support was removed - #4886

Open
Adham-Kiwan wants to merge 1 commit into
kptdev:mainfrom
Adham-Kiwan:docs-wasm-removed
Open

Adham-Kiwan wants to merge 1 commit into
kptdev:mainfrom
Adham-Kiwan:docs-wasm-removed

Conversation

@Adham-Kiwan

Copy link
Copy Markdown

Description

This is the documentation part of the WASM removal (#4881). It goes with #4885, which removes the runtime itself. Please merge it after #4885, or together with it.

  • reference/cli/fn/eval and reference/cli/fn/render: the --allow-alpha-wasm entries now say the flag is deprecated and that functions run with it fail with an error.
  • reference/cli/alpha/wasm: adds a warning box. It says kpt used to run WASM functions, that the feature was removed and why, and points readers to container images or executables. This keeps the one section the issue asks for.
  • internal/docs/generated/fndocs/docs.go: regenerated with mdtogo, so kpt fn eval --help and kpt fn render --help match.

I searched documentation/ for other WASM mentions and found none outside these pages. The kpt alpha wasm push/pull pages describe commands that #4885 keeps, so I left them unchanged.

Fixes #4883

AI usage

I have used AI in the creation of this PR.

I have used the following AI tools:

  • Claude Code (Claude Opus 5.5) to find the WASM references in the docs, draft the wording, and regenerate the embedded docs

I have reviewed the change and can explain it independently of the tool.

Update the --allow-alpha-wasm flag reference for fn eval and fn render,
and add a note to the alpha wasm page that says running WASM functions
was removed and why. Regenerate the embedded CLI docs.

Fixes kptdev#4883

Assisted-by: Claude Code (claude-opus-5-5)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Adham Kiwan <adhamkiwan@outlook.com>
@Adham-Kiwan
Adham-Kiwan requested review from a team and a balanced review from Copilot November 18, 2026 23:35
@netlify

netlify Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for kptdocs ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 83c1886
🔍 Latest deploy log https://app.netlify.com/projects/kptdocs/deploys/6afe364cb8400b304e8de479
😎 Deploy Preview https://deploy-preview-4886--kptdocs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The WASM documentation uses a noncompliant alert title and incorrectly states that all function runs with --allow-alpha-wasm fail, although ordinary executables still run.

2 open issues
What changed in this PR

Documents the removal of WASM function execution, complementing runtime removal in #4885 while preserving the WASM OCI management command documentation.

Changes:

  • Updates fn eval and fn render flag documentation to describe deprecation and errors.
  • Adds a historical removal warning with container images and executables as alternatives.
  • Regenerates embedded CLI help to match the reference pages.
File Description
internal/​docs/​generated/​fndocs/​docs.go Updates embedded eval and render help text.
documentation/​content/​en/​reference/​cli/​fn/​render/​_index.md Documents deprecated WASM flag behavior for pipelines.
documentation/​content/​en/​reference/​cli/​fn/​eval/​_index.md Documents deprecated WASM flag behavior for individual functions.
documentation/​content/​en/​reference/​cli/​alpha/​wasm/​_index.md Adds the removal warning, rationale, and alternatives.

Review effort: Balanced

The `wasm` command group contains subcommands for managing WASM modules as OCI images.
<!--mdtogo-->

{{% alert title="WASM functions are no longer supported" color="warning" %}}
Comment on lines +24 to +25
no longer maintained, and the feature saw little use. The flag is still accepted, but any function run
with it fails with an error. Run your functions as container images or executables instead. See

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update WASM related documentation

2 participants